RENAME

            
#include <io.h>    требуется  только  для   объявления функции
#include <stdio.h> использует   либо   <io.h>,    либо <stdio.h>
int rename (oldname,newname);
char *oldname;      указатель на старое имя
char *newname;      указатель на новое имя

Описание.
Функция rename переименовывает файл или директорий, определяемый по имени newname . Oldname должно задавать path -имя сущест вующего файла или директория. Newname не определяет имя уже существующего файла или директория. Функцию rename можно использовать для перемещения файла из одного директория в другой, если задать другое path -имя в аргументе newname . Однако, файлы не могут быть перемещены с одного устройства на другое (например, с дисковода А на дисковод В). Директории можно переименовывать и нельзя перемещать.

Возвращаемое значение.
Функция rename возвращает 0, если она выполнена успешно. В случае ошибки возвращается ненулевое значение и errno устанавливается в одно из следующих значений:

                           
               Значение                          Его смысл
                           
         EACCES               Файл  или  директорий,  заданный     по
                              newname, существует или не  может  быть
                              создан (неверный  path),   или  oldname
                              является    директорием   и     newname
                              определяет другой  path.
                
                           
         ENOENT               Файл или path-имя, заданные по oldname,
                              не  найдены.
                           
         EXDEV                Попытка  перемещения  файла  на  другое
                              устройство.

Замечание.
Нужно заметить, что порядок аргументов в rename для Microsoft C 4.0 противоположен порядку rename для ранних версий. Это изменение было сделано в соответствии со стандартом ANSI.

Пример:

            #include <io.h>
            
            int result;
            
               /* следующий оператор изменяет имя файла "input" ** на  имя
         "data" */
            
            result = rename("input", "data");
         
Hosted by uCoz